<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>将关联的数组值转换为适合 SQL 语句的格式。</title>
 </head>
 <body class="docs"><div id="layout">
  <div id="layout-content"><div id="function.pg-convert" class="refentry">
   <div class="refnamediv">
    <h1 class="refname">pg_convert</h1>
    <p class="verinfo">(PHP 4 &gt;= 4.3.0, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">pg_convert</span> &mdash; <span class="dc-title">
     将关联的数组值转换为适合 SQL 语句的格式。
    </span></p>

   </div>
 <div class="refsect1 description" id="refsect1-function.pg-convert-description">
  <h3 class="title">说明</h3>
     <div class="methodsynopsis dc-description">
      <span class="methodname"><strong>pg_convert</strong></span>
       ( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$connection</code></span>
      , <span class="methodparam"><span class="type">string</span> <code class="parameter">$table_name</code></span>
      , <span class="methodparam"><span class="type">array</span> <code class="parameter">$assoc_array</code></span>
   [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$options</code><span class="initializer"> = 0</span></span>
     ] ) : <span class="type">array</span></div>

    <p class="para rdfs-comment">
     <span class="function"><strong>pg_convert()</strong></span> 检查 <em>assoc_array</em>
     中的值并将其转换为为适用于 SQL 语句的值。<span class="function"><strong>pg_convert()</strong></span>
     的前提条件是现有的表 <em>table_name</em>
     中具有的列至少有 <em>assoc_array</em>
     中的单元那么多。<em>table_name</em>
     中的字段名以及字段值必须和 <em>assoc_array</em>
     中的键名及值匹配。如果成功则返回一个包括转换后的值的数组，否则返回 <strong><code>FALSE</code></strong>。
    </p>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    If there are boolean fields in <code class="parameter">table_name</code> don&#039;t 
    use the constant <strong><code>TRUE</code></strong> in <code class="parameter">assoc_array</code>. It will be
    converted to the string &#039;TRUE&#039; which is no valid entry for boolean fields
    in PostgreSQL. Use one of t, true, 1, y, yes instead.
   </p>
  </p></blockquote>
    <div class="warning"><strong class="warning">Warning</strong><p class="simpara">此函数是<em class="emphasis">实验性</em>的。此函数的表象，包括名称及其相关文档都可能在未来的
PHP 发布版本中未通知就被修改。使用本函数风险自担 。</p></div>
   </div>


 <div class="refsect1 parameters" id="refsect1-function.pg-convert-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>

    
     <dt>
<code class="parameter">connection</code></dt>

     <dd>

      <p class="para">
       PostgreSQL database connection resource.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">table_name</code></dt>

     <dd>

      <p class="para">
       Name of the table against which to convert types.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">assoc_array</code></dt>

     <dd>

      <p class="para">
       Data to be converted.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">options</code></dt>

     <dd>

      <p class="para">
       Any number of <strong><code>PGSQL_CONV_IGNORE_DEFAULT</code></strong>, 
       <strong><code>PGSQL_CONV_FORCE_NULL</code></strong> or
       <strong><code>PGSQL_CONV_IGNORE_NOT_NULL</code></strong>, combined.
      </p>
     </dd>

    
   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.pg-convert-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   An <span class="type"><a href="language.types.array.html" class="type array">array</a></span> of converted values, or <strong><code>FALSE</code></strong> on error.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.pg-convert-examples">
  <h3 class="title">范例</h3>
  <p class="para">
   <div class="example" id="example-2479">
    <p><strong>Example #1 <span class="function"><strong>pg_convert()</strong></span> example</strong></p>
    <div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php&nbsp;<br />&nbsp;&nbsp;$dbconn&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">pg_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'dbname=foo'</span><span style="color: #007700">);<br />&nbsp;&nbsp;<br />&nbsp;&nbsp;</span><span style="color: #0000BB">$tmp&nbsp;</span><span style="color: #007700">=&nbsp;array(<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #DD0000">'author'&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'Joe&nbsp;Thackery'</span><span style="color: #007700">,<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #DD0000">'year'&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #0000BB">2005</span><span style="color: #007700">,<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #DD0000">'title'&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'My&nbsp;Life,&nbsp;by&nbsp;Joe&nbsp;Thackery'<br />&nbsp;&nbsp;</span><span style="color: #007700">);<br />&nbsp;&nbsp;<br />&nbsp;&nbsp;</span><span style="color: #0000BB">$vals&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">pg_convert</span><span style="color: #007700">(</span><span style="color: #0000BB">$dbconn</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'authors'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$tmp</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
    </div>

   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.pg-convert-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="function"><a href="pg_meta_data.html" class="function" rel="rdfs-seeAlso">pg_meta_data()</a> - 获得表的元数据</span></li>
   </ul>
  </p>
 </div>

  </div></div></div></body></html>